package com.atguigu.exam.service;

import com.atguigu.exam.entity.Paper;
import com.atguigu.exam.vo.AiPaperVo;
import com.atguigu.exam.vo.PaperVo;
import com.baomidou.mybatisplus.extension.service.IService;

import java.util.List;

/**
 * 试卷服务接口
 */
public interface PaperService extends IService<Paper> {


    /**
     * 获取所有试卷列表
     * @param name 试卷名称
     * @param status 试卷状态
     * @return 试卷列表
     */
    List<Paper> listPapers(String name, String status);

    /**
     * 根据ID获取试卷
     * @param id 试卷ID
     * @return 试卷
     */
    Paper getPaperById(Integer id);

    /**
     * 根据试卷ID获取试卷详情
     * @param id 试卷ID
     * @return 试卷详情
     */
    Paper customPaperDetailById(Long id);

    /**
     * 手动创建试卷
     * @param paperVo 试卷创建参数
     * @return 创建完成的试卷信息
     */
    Paper createPaper(PaperVo paperVo);

    /**
     * AI智能组卷
     * @param aiPaperVo AI组卷参数
     * @return 创建完成的试卷信息
     */
    Paper createPaperWithAI(AiPaperVo aiPaperVo);

    /**
     * 自定义更新试卷
     * @param id 试卷ID
     * @param paperVo 试卷更新参数
     * @return 更新完成的试卷信息
     */
    Paper customUpdatePaper(Integer id, PaperVo paperVo);

    /**
     * 自定义更新试卷状态
     * @param id 试卷ID
     * @param status 试卷状态
     */
    void customUpdatePaperStatus(Integer id, String status);

    /**
     * 自定义删除试卷
     * @param id 试卷ID
     */
    void customRemoveId(Integer id);
}